home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 015a / tset72.zip / TIMSET72.DOC < prev    next >
Text File  |  1993-05-28  |  69KB  |  1,262 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                                 TIMESET (TM)
  26.                                 Version 7.20
  27.  
  28.  
  29.          A program to set computers to the world's most accurate clocks
  30.  
  31.  
  32.                   Copyright 1987-1993, Life Sciences Software
  33.                           8925 271st N.W., Suite 112
  34.                                   Box 1560
  35.                           Stanwood, Washington 98292
  36.  
  37.                                  206-387-9788
  38.  
  39.  
  40.             "TIMESET" is a trademark of Life Sciences Software (TM)
  41.  
  42.  
  43.  
  44.                           FEATURES OF TIMESET 7.20
  45.  
  46.   TimeSet has been evolving steadily ever since the first version was released
  47. in the summer of 1987.  That version and several subsequent ones could only
  48. set a computer's clock from the U.S. Naval Observatory (USNO) in Washington,  
  49. D.C.  Version 6.00, released in 1990, added ability to use telephone time 
  50. signals from the National Institute of Standards and Technology (NIST) in 
  51. Boulder, Colorado, making it the first program of its kind able to address 
  52. more than one atomic time service.  This made it possible for computer users  
  53. in the eastern and western United States to keep down long distance bills by 
  54. choosing the time service closest to them.
  55.  
  56.    Version 7.20 continues that evolution with a number of new features and
  57. supporting utilities:
  58.  
  59.    o  TimeSet can now access five atomic clock-based telephone time
  60.       services on two continents: the USNO and the NIST in the United
  61.       States, as before, and atomic time services in Sweden (Swedish
  62.       National Time Service), Austria (Technical University of Graz), and
  63.       Italy (National Electrotechnical Institute).  People in European
  64.       countries who want to set their computers to an atomic clock no
  65.       longer need to make a trans-Atlantic phone call.  In addition, to
  66.       these formal services, TimeSet 7.20 can access any number of services
  67.       that use TimeGen, a companion program in this package that generates 
  68.       time data strings in Naval Observatory format.
  69.  
  70.    o  TimeSet 7.20 is designed to interact closely with versions 2.53 and
  71.       2.54 (or later) of RighTime (tm), the excellent memory-resident
  72.       regulator for computer clocks developed by Tom Becker of Air
  73.       System Technologies, Inc., Dallas.  RighTime learns the drift rate in
  74.       the computer's clock and continuously applies a correction to
  75.       compensate for it, and it refines the correction each time the
  76.       computer clock is set.  A computer with RighTime installed and
  77.       trained can maintain system clock accuracy within a second or even a
  78.       fraction of a second for at least a week.  Furthermore, versions of
  79.       RighTime later than 2.53 provide true 0.01-sec resolution in the DOS
  80.       clock, in contrast to the normal 0.055-sec resolution.  This allows
  81.       greater accuracy in PC clocksetting than ever before, indeed the
  82.       maximum accuracy that can be obtained with a computer clock.  Life
  83.       Sciences Software and Air System  Technologies cooperated closely
  84.       during the development of TimeSet 7.20 and RighTime 2.5+, with
  85.       the result that TimeSet can access several RighTime functions
  86.       directly. 
  87.  
  88.    o  In addition to the ability to address five official atomic clock time
  89.       sources on two continents, users of TimeSet 7.20 can get time from
  90.       Life Science Software's program TimeGen (tm) version 3.1.  TimeGen, 
  91.       part of the TimeSet 7.20 distribution package, is a program that 
  92.       generates time data strings for Universal Time using the Naval
  93.       Observatory's format.  Its purpose is to allow one computer in a 
  94.       local system to get accurate time from an official service, then share
  95.       it by telephone with many other computers in the local system, in
  96.       effect making the TimeGen-equipped computer a "substation" of an 
  97.       official atomic time service.  
  98.  
  99.    o  TimeSet 7.20 is accompanied by a utility called AutoDial, which can be
  100.       installed memory resident to trigger TimeSet to call a specified time
  101.       service at a particular time every day.  Also included in the TimeSet 
  102.       7.20 package is the IF2DAY.COM utility by Gary Miller, which can be 
  103.       used to initiate a call by TimeSet during system bootup on a specific
  104.       day of the week or month.
  105.  
  106.    o  Another new feature in TimeSet 7.20 is optional automatic
  107.       reconfiguration when the time season changes between daylight savings
  108.       time and standard time, plus ability to calculate the dates when those
  109.       season changes will occur during the current year.  Unlike Version 
  110.       7.10, which offered automatic season reconfiguration only for users 
  111.       in North America, TimeSet 7.20 also offers this feature for users
  112.       following the time season rules of Europe and the British Isles.
  113.  
  114.    o  TimeSet 7.20 allows custom serial port configuration, making it usable
  115.       with serial ports up to COM8 and nonstandard IRQs and port addresses.
  116.  
  117.    o  Also in response to many requests, TimeSet is now able to save data
  118.       on your computer clock to a disk file each time you call a time
  119.       service, allowing clock drift in the computer to be analyzed.  It also
  120.       produces error level codes for use by the DOS ErrorLevel command in 
  121.       batch files.
  122.  
  123.  
  124.                               SHAREWARE NOTICE
  125.  
  126.   TimeSet is a copyrighted commercial program.  It is not free nor is it in 
  127. the public domain.  It is a shareware program, which means you may obtain it
  128. from a computer bulletin board or other source and try it out before paying
  129. for it.  You are expected to pay for the program and become a registered
  130. user if you continue using it after a trial period of two weeks.  Life 
  131. Sciences Software retains all rights to TimeSet, its associated programs, 
  132. and their names, which are trademarked.  Sale of these programs by others is
  133. prohibited.  However, firms that specialize in the distribution of shareware
  134. programs and charge only for that service are permitted to include the
  135. TimeSet package in their libraries, provided they notify customers that it is
  136. shareware and that they are expected to register shareware programs and
  137. send payment to the authors of those programs if they continue to use them.
  138.  
  139.   If you register and pay for TimeSet you get the following benefits: (1)
  140. technical support; (2) a printed and bound illustrated manual; (3) an
  141. evaluation copy of Air System Technologies' RighTime program; (4) a discount 
  142. on the next version of TimeSet when it becomes available.
  143.  
  144.   Two procedures are available for registration: 
  145.   
  146.   1.  You can fill out the registration form at the end of this document
  147.       and mail it to us with a check or money order.  The cost is $40.00
  148.       U.S. if you are not now a registered user of a previous version of 
  149.       TimeSet.
  150.  
  151.       If you are already a registered user, the following price schedule
  152.       applies for each copy of TimeSet 7.20:
  153.  
  154.        o        TimeSet version 6.00A ordered between November 1,
  155.                 1992 and February 15, 1993, but not yet shipped --
  156.                 $35.00 (the same price as the version you expected to
  157.                 get).
  158.  
  159.        o        Registered, paid for, and received a previous version
  160.                 between January 1, 1992 and October 30, 1992 -- $20.00
  161.                 (half-price).
  162.  
  163.        o        Registered, paid for, and received a previous version
  164.                 before January 1, 1992 -- $25.00 (37.5% off).
  165.  
  166.   2.  Alternatively, you can use the accompanying program TsReg72.EXE
  167.       to upload your name, address, and other information to our toll-free
  168.       electronic mailbox (an 800 number).  We will then send you an
  169.       invoice, and on receipt of your payment (according to the above
  170.       schedule) send you a fresh copy of TimeSet 7 with the latest
  171.       revisions, if any, plus a printed manual.  This is a convenience for
  172.       people who, like many of us, intend to register shareware but forget
  173.       to do it.  It is also useful to businesses that require invoicing. 
  174.       Running TsReg72.EXE is very simple, involving no more than
  175.       answering a few prompts about your system and your modem and
  176.       typing in the information we need to send you an invoice.
  177.  
  178. (NOTE:  Since Version 7.20 corrects some minor defects that became apparent 
  179. in Version 7.10 after it was released, people who have already registered for 
  180. TimeSet 7.10 need not register this new version.)
  181.  
  182.  
  183.  
  184.                             TIMESET CONFIGURATION
  185.  
  186.  
  187.   TimeSet is designed for very easy configuration.  If the copy you have has
  188. never been run before, it will automatically present a screen showing a 
  189. default configuration (Figure 1).  If you press F10 while this screen is 
  190. displayed, that data will be saved to TimeSet's own file, and TimeSet will 
  191. subsequently bypass configuration and use the saved data each time you run it.
  192.  
  193.   It is likely, however, that you'll need to make some changes in the default
  194. setup before pressing F10.  For example, you may need to configure the
  195. program for your own time zone, the season of the year (daylight or standard
  196. time), your serial port, etc., or you may need to insert some prefixes in the
  197. telephone numbers that are displayed for the various time services.  Such
  198. changes are simple to make.  All you need to do is press the up or down
  199. arrow key to highlight the configuration item you wish to change.  Then,
  200. depending on the particular configuration item, you can do it either by
  201. toggling a new option with the right or left arrow key or by editing what is
  202. displayed on your screen.  TimeSet will tell you which method to use, toggling
  203. or editing, to make your change.
  204.  
  205.   The configuration process, then, involves examining the existing setup,
  206. scrolling to the lines that need change, making the necessary changes, then
  207. saving the configuration by pressing F10.  Each configuration item has its 
  208. own help screen.  If a configuration line is highlighted, all you need to do 
  209. to get help for that line is press F1 (aim carefully; if you press the nearby 
  210. ESC key, you'll be out of the program and back in DOS).  
  211.  
  212.   We strongly urge that, before making any changes, you review all the help
  213. screens by pressing F1 as you highlight each configuration item on the list. 
  214. The help screens comprise an on-line tutorial, and not all the items are
  215. discussed in detail in this manual.  In fact, it would be a good idea to load
  216. TimeSet right now and have the configuration screen in front of you as you
  217. read this section.  If TimeSet has already been configured, you can force it 
  218. to load in configuration mode by using /C on the DOS command line 
  219. (TIMESET /C).
  220.  
  221.  
  222. TELEPHONE NUMBERS
  223.  
  224.   The first five lines on the configuration screen deal with phone numbers for
  225. time services.  The first line, labled "Outside phone," is not likely to be
  226. needed by most users, who can leave it at the default "NULL." It is intended
  227. for those who need to dial a special phone number before they can dial a
  228. regular long distance number.  Often the special number will be that of a
  229. long distance carrier that is not accessible by the standard 1 prefix that 
  230. brings your assigned carrier when you make a long distance call. To put in 
  231. such a number, press Enter to get in editing mode, delete NULL, type in the 
  232. phone number, then press Enter again to get out of editing mode.
  233.  
  234.   The second line is the long distance number for the U.S. Naval Observatory. 
  235. It is preceded by a 1, based on the assumption that you have an assigned long
  236. distance carrier.  If you do not, or if you wish to use a carrier that has not
  237. been assigned to you, get into editing mode and insert, in front of everything
  238. else, the numbers that get you a particular long distance company.  To get
  239. AT&T, for example, you would insert 10288 ahead of what is already there. 
  240. The same considerations apply to the third line, for calling the National
  241. Institute of Standards and Technology. 
  242.  
  243.   The fourth line, titled "European service," has NULL as the default.  If 
  244. you live in North America, you'll probably want to leave it that way since 
  245. time is available at far less expense by calling the USNO or NIST.  European 
  246. users can get phone numbers for time services in Sweden, Austria, and Italy 
  247. simply by toggling with the right or left arrow key.  Note that the European 
  248. phone numbers are preceded by a plus sign (+).  You will need to get into 
  249. editing mode to replace the plus sign with the international calling code 
  250. used in your own country (in the U.S., the number is usually 011).
  251.  
  252. IMPORTANT NOTE:  There is no assurance that any of the European time
  253. services will remain available to callers who do not live in the host country. 
  254. When when TimeSet 7.20 was released, some European services were planning to
  255. make calls chargeable to the caller's phone bill (equivalent to a 900 number 
  256. in the United States), which would make the service unavailable to callers 
  257. using the telephone system of another country.  It is possible, however, that 
  258. other European countries will begin providing telephone time services, using 
  259. the same data format Sweden, Austria, and Italy have adopted.  Should that 
  260. occur, it will then be possible to replace existing European phone numbers in 
  261. TimeSet by editing, so new services in other countries can be called.
  262.  
  263.   The fifth line, labeled "TimeGen service," is for users who wish to call a
  264. time service based on the program TimeGen, which is part of the TimeSet
  265. 7.20 package.  TimeGen generates time data strings in U.S. Naval Observatory 
  266. format, allowing a computer that is synchronized with an official atomic time 
  267. service and stabilized by RighTime to transmit the time via modem to other 
  268. computers equipped with TimeSet 7.20.  The default for line 5 is NULL, but if 
  269. you wish to call a TimeGen service (which we hope will proliferate), get into 
  270. editing mode and replace NULL with the appropriate phone number.  TimeGen is 
  271. described in detail in a separate section.
  272.  
  273.  
  274. TIME ZONES AND TIME SEASONS
  275.  
  276.   Line 6 is the line for selecting your time zone, and the default is (North
  277. American) EASTERN time.  If you live in, say, Miami, you don't need to do
  278. anything with that line.  If you live in Denver, however, you are in the
  279. Mountain time zone, and you'll need to scroll to line 6 using the up or down
  280. arrow key, then press the right or left arrow key until the word "MOUNTAIN" 
  281. appears.  All the major named North American time zones are built into 
  282. TimeSet and  are available by toggling.  If you don't live in North America, 
  283. just go to line 6 and keep pressing the right or left arrow key until TimeSet 
  284. tells you that you can enter editing mode.  Then press Enter to get in editing 
  285. mode, and type in the number of hours your time zone is offset from universal 
  286. time (the time at the zero meridian, sometimes called Greenwich time, or 
  287. "Zulu" time).  If you live in Sweden, for example, your time zone is 2 hours 
  288. later than universal time so you would need to type in a 2.  The convention 
  289. that must be followed here is to make the number positive if you are east of 
  290. Greenwich, England and west of the International Date Line, and negative if 
  291. you are west of Greenwich and east of the International Date Line.
  292.  
  293.   Configuration for daylight saving time or standard time (or Summer Time
  294. and Winter Time, as they are called in Europe) is available on line 7.  Simply
  295. scroll to that line and toggle DAYLIGHT or STANDARD with the right or
  296. left arrow key.
  297.  
  298.   Some people need to have their computers set to universal time (in aviation
  299. and astronomy, for example).  That option is also available by toggling at 
  300. line 6.  Notice that when the word UNIVERSAL appears on line 6, the word
  301. NULL automatically appears on line 7, the time season line.  This is because 
  302. universal time has no seasons; it is always standard time.  (If you live in 
  303. the United Kingdom and want your computer to be on local civil time, you 
  304. should not select UNIVERSAL.  The reason is that civil time in Britain has 
  305. seasons and you will need to make a season selection on line 7.  Instead 
  306. enter 0 as your offset from Greenwich on line 6 so you can toggle the 
  307. appropriate time season on line 7.  If you wanted U.K. civil time and 
  308. selected UNIVERSAL on line 6, the NULL on line 7 would cause your clock to 
  309. remain on standard time, i.e., winter time, all year long, and thus an hour 
  310. slow for the duration of summer time.)
  311.  
  312.  
  313. MODEM CONFIGURATION
  314.  
  315.   Lines 8-12 are for configuring TimeSet to work with your modem.  With
  316. line  8 highlighted you can select the appropriate serial port (COM1-COM4)
  317. by toggling with the right or left arrow key.  As you toggle through the
  318. options, you will see the default port address and IRQ number for each port,
  319. for both standard computers and PS/2 computers.  COM1 and COM2 use the
  320. same addresses and IRQs in standard and PS/2 machines, but PS/2 computers
  321. use different addresses and IRQs for COM3 and COM4.  If you have a PS/2
  322. and want to use COM3 or COM4, just keep toggling until you see the correct
  323. port configuration  for a PS/2 computer (configurations unique to PS/2s are
  324. identified as they come into view).
  325.  
  326.   In addition to the standard port configurations available by toggling at 
  327. line 8, TimeSet 7.20 allows configuration for nonstandard serial port 
  328. addresses and IRQs.  Just keep toggling until the editing flag is shown, 
  329. then edit the template string that appears, replacing the n's with actual 
  330. numbers. It is very important to press F1 so you can read the help screen 
  331. for this item.  Note also that the port address you type in must be in 
  332. hexadecimal notation.  This feature in TimeSet 7.20 should allow the program 
  333. to be used with any serial port using any port address and any IRQ line.  
  334. Caution is needed, however.  If you selected an IRQ that is being used by a 
  335. disk drive, for example, you could cause some serious problems.  Know what 
  336. you are doing; check to see what IRQs are available for your COM port before 
  337. proceeding.
  338.  
  339.   Line 9 allows you to toggle your dialing method.  For most people, it will
  340. be either TONE or PULSE.  A third option, AUTO, will be of no use to
  341. most users.
  342.  
  343.   Lines 10, 11, and 12 need to be considered together.  Line 10 allows you to
  344. select a dial-up speed for your modem.  There is really no need for it to be
  345. anything greater than 1200 bps, since that is the speed all the standard
  346. telephone time services use.  Local speeds up to 153000 bps can be toggled
  347. with the  right or left arrow key, although few modems go that high.  
  348.  
  349.  
  350. High-Speed Modems
  351.  
  352.   If you have one of the newer modems that allow you to maintain a high
  353. speed locally, i.e., between your serial port and your modem, while allowing
  354. the modem to drop the line speed to match the remote modem, you can use
  355. that kind of action with TimeSet 7.20, but you'll need to make correct choices
  356. on lines 10, 11, and 12.  First, you will need to toggle line 10 to some high
  357. speed, such as 38400.  Second, you will need to toggle line 11 (labeled "Lock
  358. modem  speed") to YES.  This will tell TimeSet not to adjust the speed
  359. setting at the serial port after connection is made but to leave it at the 
  360. high speed at which it was opened.  Third, on line 12 (labeled "User's 
  361. commands") you will need to insert an appropriate command to tell your modem 
  362. to maintain the local speed high while allowing the line speed to drop to 
  363. match that of the remote modem.  For many of the newer high-speed modems, 
  364. that command is &B1.
  365.  
  366.   Thus, if you wanted to dial at 38400 bps and maintain that same speed
  367. locally after connection while allowing the modem's line speed to match the
  368. 1200 bps time service modem, lines 10, 11, and 12 would have to show the
  369. following:
  370.  
  371.    Line 10 (Dialing baud rate): 38400   (could be as low as 1200)
  372.    Line 11  (Lock modem speed): YES
  373.    Line 12   (User's commands): ...&B1... (&B1 inserted in an existing string)
  374.  
  375. The command your own modem uses for keeping the local speed locked high
  376. may be something other than &B1.  Please check your modem manual to find
  377. out the correct command.
  378.  
  379.   Toggling on the user's command string line produces three different modem
  380. initialization strings.  The first one, &C1&D2X4, which is the default, is for
  381. initializing older modems that do not feature error checking and data
  382. compression -- for example, a 2400 baud Hayes Smartmodem.  The second,
  383. which reads &F&B1&C1&D2X4S37=5, should work with most of the newer
  384. high speed modems that use data compression and error checking protocols. 
  385. It is essential that all such protocols be disabled and that the modem be set
  386. instead for basic asynchronous mode.  In several of the newer modems this is
  387. accomplished by a single command, &F, which brings in factory defaults for
  388. that mode.  If your modem uses some other command to be put into basic
  389. asynchronous mode, use the editing function and replace &F in this string
  390. with the appropriate command  for your modem.  It may also be necessary to
  391. use a separate command to turn off all flow control in newer modems that
  392. use hardware flow control (RTS/CTS) as a default, if that command is not
  393. part of the defaults for basic asynchronous mode.  In many newer modems
  394. the command for turning off all flow control is &K0.
  395.  
  396.   Turning off flow control is essential to avoid a situation where TimeSet
  397. waits endlessly for a Request to Send that is not produced by any of the time
  398. service modems.  As noted earlier, &B1 in this string tells the modem to hold
  399. the local (port to modem) speed constant while allowing the line speed to
  400. match that of the remote modem.  If your modem uses some other command
  401. for this, using the editing function to replace &B1.
  402.  
  403.   One more toggle brings up the string %C0&Q6N0\G0&C1&D2X4S37=5, which is
  404. specifically for use with Zoom 14.4 Fax and similar modems.  This option is
  405. provided because the Zoom, while it is a very popular low-cost brand, has
  406. generated more configuration problems for TimeSet users than any other brand.
  407.  
  408.   Finally, if none of the hard-coded initialization strings works with your
  409. high-speed modem, here is another string you can try, using the editing 
  410. function on the User's command line:  &C1&D2X4N0B1S37=5&Q0.  This has been
  411. reported to work with the Boca and several other brands.
  412.  
  413.  
  414. Conventional Modems
  415.  
  416.   The default user's initialization string in line 12 (User's commands) is
  417. &C1&D2X4.  This is the string to use with conventional modems, with speeds
  418. no higher than 2400 bps and with no error checking or data compression
  419. protocols.  These are what today might be considered "old-fashioned" modems, 
  420. capable of only basic asynchronous communication.  The commands &C1 and &D2 
  421. in the string are discussed in the next section, but notice that they are 
  422. needed for the newer modems as well.  X4 in this string tells the modem to 
  423. use a result code set that includes the words CONNECT, NO CARRIER, NO 
  424. DIALTONE, and BUSY.
  425.  
  426.   Some very early modems lack a result set that includes BUSY.  If yours is
  427. of that vintage you probably can use an Xn value no higher than X2 or X3. 
  428. In that case you will have to edit to change X4 to the highest Xn value your
  429. modem can use.  Since the modem will not be able to detect and report a
  430. busy signal, you will need to rely instead on the timing-out of register S7 to
  431. cause the words NO CARRIER to be sent to TimeSet by the modem if connection 
  432. is not made in a reasonable time.  TimeSet will then assume that the line is 
  433. busy (though it may not actually be) and take the same actions it would if an 
  434. actual BUSY report had been received.  The timing of S7 is hard-coded at 45 
  435. seconds in TimeSet (S7=45), but you can adjust it upward or downward simply 
  436. by adding an S7=nn command to the user's initialization string using TimeSet's 
  437. editing functions.
  438.  
  439.  
  440. Carrier Detection and Hanging Up
  441.  
  442.   Please note that for practically all newer modems, whether conventional or
  443. high speed, &C1 and &D2 in the default initialization strings must always be
  444. left in place.  &C1 tells such modems to wait for a carrier, not to assume one
  445. is always present.  &D2 tells such modems to hang up when the DTR is dropped.  
  446. If these functions are not present, TimeSet will not work properly.  The only 
  447. users who should remove those commands are those using older modems that 
  448. cannot be configured by software commands and must rely instead on dip switch 
  449. settings to accomplish the functions of &C1 and &D2.  If you have that type 
  450. of modem, use the editing functions to remove those commands from the 
  451. initialization string.  Then, before running TimeSet, adjust dip switches on 
  452. your modem as specified by your modem's manual to make it always wait for a 
  453. carrier and to hang up when the DTR is dropped.
  454.  
  455.  
  456. Carriage Returns in Modem Initialization Strings
  457.  
  458.   Although most people will never need to insert a carriage return in the
  459. modem initialization string, the capability is provided for special situations. 
  460. The effect of the carriage return is to terminate a preceding configuration
  461. string so a second one can be sent.  Thus a carriage return can be used to
  462. create two user initialization strings on the modem initialization line.  The
  463. character to use if you want a carriage return is the colon (:).  This was
  464. chosen instead of the more common ^M symbol because it takes one less
  465. character.  Remember that if you use the colon, the string that comes after it
  466. should start with AT, but also remember that the string that starts after a
  467. colon is the only place where AT is allowed, since TimeSet itself supplies 
  468. that command elsewhere.  In other words, no string that's sent to the modem 
  469. by TimeSet should have the letters AT at the far left.  By the way, the colon
  470. also causes a carriage return to be sent to the modem if it's inserted in a
  471. phone number string, which may be useful in some complex dialing situations.
  472.  
  473.  
  474. THE COMPUTER CLOCK
  475.  
  476.   Line 13, another toggle line (labeled "Computer clock"), allows you to
  477. specify the manner in which TimeSet will set the time in your computer.  The
  478. default setting is to have TimeSet set the DOS clock/calendar only.  This is
  479. the setting to use if either of the following conditions is true: (1) your
  480. computer has only a DOS clock/calendar or (2) your computer has both a
  481. DOS clock/calendar and a battery powered real-time clock, and furthermore
  482. has resident software to instantly pass new time and date settings from DOS
  483. to the battery powered clock.  If your battery-powered clock is a CMOS
  484. clock, the only resident software you need for this is DOS itself, provided 
  485. it's version 3.3 or later.  If your computer does not have a CMOS clock and
  486. instead uses the XT-style real-time clock that plugs into a card slot in the
  487. computer, the resident software you'll need to install is Tom Strickland's
  488. ClockDrv.SYS (install it in your CONFIG.SYS file), which is included in the
  489. TimeSet package.  With either kind of battery powered clock, any setting
  490. TimeSet makes in the DOS clock/calendar will instantly be passed on to the
  491. battery clock, provided the appropriate memory-resident software for that
  492. clock is installed (DOS 3.3 or later for the CMOS clock, ClockDrv.Sys for
  493. XT-style battery powered clocks).
  494.  
  495.   Pressing the right or left arrow key while line 13 is highlighted displays
  496. one more clocksetting option, which reads "CMOS, DOS ver. < 3.3."  This
  497. setting is for users who have a computer with a CMOS clock but are using a
  498. version of DOS earlier than version 3.3.  Those older versions of DOS do not
  499. automatically pass changes in the DOS clock/calendar to the CMOS clock and
  500. instead require use of the SETUP utility.  Toggling this configuration option
  501. allows TimeSet to set both the DOS clock and the CMOS clock directly and
  502. at practically the same instant, thus eliminating the need to run SETUP.  Do
  503. NOT select this option if your DOS version is 3.3 or later.
  504.  
  505.  
  506. AUTOMATIC TIME SEASON ADJUSTMENT
  507.  
  508.   TimeSet 7.20 makes automatic reconfiguration for time season changes
  509. available to all users, whether they follow the North American system (where
  510. daylight time starts on the first Sunday in April and standard time starts on
  511. the last Sunday in October), the continental European system (where Summer
  512. Time starts on the last Sunday in March and Winter Time starts on the last
  513. Sunday in September), or the British system (where Summer Time starts on
  514. the last Sunday in March and Winter Time, or GMT, starts on the day after
  515. the fourth Saturday in October).  This is in contrast to Version 7.10, which 
  516. offered automatic season changes only to those using the North American 
  517. system.
  518.  
  519.   Toggling at Line 14, labeled "Auto time season," presents four options:
  520. AUTOMATIC SEASONS U.S.A., AUTOMATIC SEASONS EUROPE, AUTOMATIC
  521. SEASONS BRITAIN, and MANUAL SEASONS.  The first three configure TimeSet to
  522. follow the desired season rules automatically, as described in the preceding
  523. paragraph.  The fourth option, MANUAL SEASONS, requires you to keep track of
  524. time season changes and to reconfigure the program for a new season by pressing
  525. F7 before the next call to a time service.  It is included mostly for the
  526. benefit of people who live in countries that do not use either the North
  527. American, European, or British conventions for time season changes.
  528.  
  529.   If any automatic season change mode is selected, TimeSet will automatically
  530. reconfigure for a new time season the first time it is used after a season
  531. change has occurred.  The adjustment, which occurs immediately after the
  532. time is obtained from a service, reconfigures TimeSet for the appropriate time
  533. season and simultaneously advances the clock one hour (daylight time) or sets
  534. it back one hour (standard time).  There is one exception to this, however: If
  535. TimeSet 7.20 detects the presence of RighTime 2.53 (or a later version) and
  536. also detects that RighTime has been loaded with the /A switch, which provides 
  537. automatic system clock adjustment when seasons change, it will make no time 
  538. adjustment and instead will only reconfigure for the appropriate season in 
  539. order to have the correct offset from UTC for calculating local time.  
  540. Detecting RighTime's /A switch is essential since the result otherwise would 
  541. be a two-hour change in the system clock -- one from RighTime and another 
  542. from TimeSet.
  543.  
  544.   In TimeSet 7.20 the dates for automatic time season changes are calculated
  545. by an algorithm that is good indefinitely or until conventions regulating the
  546. dates these changes occur are changed by a government.  If the conventions
  547. for time season changes are altered in your country, the automatic season
  548. reconfiguration will no longer work properly and you will have to revert to
  549. manual season reconfiguration until a new version of TimeSet becomes
  550. available to deal with the new rules.  Although NIST and the Swedish and
  551. Austrian time services all provide dates for the next season change in their
  552. data strings, TimeSet does not use them and instead calculates the dates 
  553. itself.  The reason is that the U.S. Naval Observatory and the Italian 
  554. service do not provide such information in their data strings.  Since a way 
  555. had to be provided for TimeSet to calculate change dates for those services, 
  556. it made sense to reduce program code by calculating them for all the services.  
  557. A further important advantage in this approach is that it allows a user to 
  558. get automatic season adjustment according to rules of his own country even 
  559. when getting time from another country that follows a different convention 
  560. for season change dates.
  561.  
  562.  
  563. MANUAL OR AUTOMATIC DIALING
  564.  
  565.   Line 15 (labeled "Manual/Auto dial") provides a choice of operating TimeSet 
  566. manually, that is, initiating a call to one of the time services by pressing 
  567. appropriate keys at the main menu, or configuring it to dial one of the time 
  568. services automatically as soon as the program is loaded.  Automatic operation 
  569. is included specifically for those who want to run TimeSet out of a batch 
  570. file as part of the bootup procedure.  In automatic mode, the program runs, 
  571. gets the time from the preselected service, sets the clock, and immediately 
  572. exits to DOS.
  573.  
  574.   There are several options for automatic operation, depending on the service
  575. you plan to call, namely USNO, NIST, a European service (the specific service 
  576. determined by the phone number you used in line 4), and a TimeGen service 
  577. (determined by the phone number you entered on line 5).  For all but the 
  578. Italian service, there is an option to make a call with or without line delay
  579. measurement (the Italian service does not offer line delay measurement).  Line 
  580. delay measurement is indicated by /LAG following the name of a particular 
  581. service toggled into view with the right or left arrow key.
  582.  
  583.   If TimeSet is configured for automatic operation and dialing is interrupted
  584. by pressing the backspace key, the program will jump to the main menu and
  585. revert to manual operation for the remainder of that session.  The next time
  586. it is loaded it will again be in automatic mode.  If you want to switch from 
  587. an automatic mode to manual mode semi-permanently, you will have to 
  588. reconfigure the program and select MANUAL at line 15.
  589.  
  590.  
  591. COLOR OR MONOCHROME
  592.  
  593.   If you have a color monitor, toggle COLOR on line 15 (labeled "Video
  594. type"). Toggle MONOCHROME if you have a monochrome monitor.  Selecting 
  595. monochrome display is also useful on laptop computers that may not show 
  596. sufficient contrast between certain colors in TimeSet.  Toggling between 
  597. color and monochrome display is also available at the TimeSet main menu by 
  598. pressing F8, and is also obtainable by using /m on the command line.
  599.  
  600.  
  601. SAVING YOUR CONFIGURATION
  602.  
  603.   Again, before even starting to make any configuration changes, you are urged 
  604. to scroll to each configuration line and press F1 to read the help screen
  605. associated with that line.
  606.  
  607.   When all configuration changes are made, they must be saved to TimeSet's
  608. own disk file by pressing F10 at the configuration screen.  Please note that
  609. even though a fresh copy of TimeSet shows a full set of configuration data on
  610. the configuration screen, the data is only a starting point for any changes 
  611. you might need to make and is not yet in a form that's functionally accessible 
  612. to the program.  Thus, even if the defaults are acceptable and you make no
  613. changes, you will still have to press F10, otherwise you will find yourself 
  614. at the configuration screen the next time you run the program.
  615.  
  616.  
  617. RECONFIGURING TIMESET
  618.  
  619.   After TimeSet has been configured, you can get the configuration screen
  620. again in two ways: (1) press F2 at TimeSet's main menu, or (2) load TimeSet
  621. with /C on the command line.  You can then make any changes you want, but
  622. be sure to press F10 if you want to save them.  If you only want to inspect
  623. the settings, you can get to the main menu by pressing F2.
  624.  
  625.  
  626.  
  627.                             OPERATING PROCEDURES
  628.  
  629.   If TimeSet has been configured to run in one of the automatic modes, it
  630. will immediately begin dialing the time service you selected for automatic
  631. calling during configuration.
  632.  
  633.  
  634. THE MAIN MENU
  635.  
  636.   If you configured for manual operation, or if you interrupt automatic 
  637. dialing by pressing the backspace key, the program jumps to the main menu 
  638. screen (Figure 2), one of whose main features is a large digital time display, 
  639. and waits for you to enter commands at the keyboard.  The command options at
  640. the main menu are in two categories: dialing commands and what might be called 
  641. housekeeping commands.
  642.  
  643.  
  644. Dialing Commands
  645.  
  646.   Dialing commands for calling specific time services include W for the Naval 
  647. Observatory in Washington; B for the National Institute of Standards and
  648. Technology in Boulder, Colorado; E for the European time service you selected 
  649. during configuration (by putting in its phone number); and T for the TimeGen 
  650. service you selected during configuration (again by putting in its phone 
  651. number).  There are two options for each of these letters -- the letter alone, 
  652. which initiates a call the specific time service without a request for line
  653. delay measurement, and the letter combined with the Alt key (Alt-W, Alt-B,
  654. etc.), which initiates a call to the specific time service with a request for line
  655. delay measurement.  (If the phone numbers for a European time service and a 
  656. TimeGen time service were left as "NULL" during configuration, the keys for 
  657. calling those services at the main menu will be nonfunctional.)
  658.  
  659.  
  660. Housekeeping Commands
  661.  
  662.   Nearly all commands at the main menu that are in the category of 
  663. "housekeeping" involve use of function keys.  The relevant function keys are 
  664. F1, F2, F7, F8, and F9.  
  665.  
  666.   F1 brings a help screen that explains the other function keys as well as 
  667. other commands at the main menu.
  668.  
  669.   F2 allows access to the configuration screen for checking or making changes.
  670.  
  671.   F7 toggles daylight or standard time.  That is, if TimeSet is configured for
  672. standard time, pressing F7 will reconfigure it for daylight saving time and
  673. simultaneously advance the system clock one hour.  If TimeSet is configured
  674. for daylight saving time, pressing F7 will reconfigure for standard time and 
  675. set the clock back one hour.  (This function is not needed if you have 
  676. configured TimeSet for automatic time season adjustment, unless your country 
  677. changes its rules concerning the dates when those changes occur.)
  678.  
  679.   F8 toggles monochrome or color display.  This function will probably be most
  680. useful when running TimeSet on certain laptop computers that do not produce 
  681. gray equivalents of certain colors with sufficient contrast.
  682.  
  683.   F9 allows a pulse to be generated at the parallel port at the instant the
  684. clock is set by a call to one of the time services.  If this feature is 
  685. activated, the pulse, with a duration of approximately 55 ms, will occur at 
  686. pin 1 of the parallel port.  It is a negative-going pulse in which the voltage 
  687. at pin 1 drops from +5 volts to 0 volts with respect to pin 25 (ground).  
  688. However, it can be inverted and otherwise shaped to drive an external 
  689. electronic device of the user's own design.  (A printer should not be attached 
  690. to the parallel port if this feature is used.)  If the /LPTn command is not 
  691. used on TimeSet's command line to designate the printer port to be pulsed, 
  692. TimeSet will use LPT1 as the default.
  693.  
  694.  
  695. F5 Access to RighTime
  696.  
  697.   Another function key, F5, is active only if TimeSet 7.20 has detected the
  698. presence of RighTime ver. 2.53 or later.  Pressing F5 in that case produces
  699. information about RighTime's current status and also allows some of RighTime's 
  700. functions to be controlled (Figure 3).  Status information includes the time 
  701. in days and hours since the computer clock was last set, RighTime's current 
  702. warm and cool corrections, whether RighTime's learning function is turned on 
  703. or off, whether the next time and date setting will be ignored, whether 
  704. RighTime's maintenance of the DOS clock is turned on or off, whether 0.01 
  705. sec resolution in the DOS clock is enabled or disabled, and whether automatic 
  706. season adjustment in the CMOS clock is enabled or disabled by RighTime.
  707.  
  708.   Control functions for RighTime accessible with TimeSet 7.20 include
  709. disabling  of RighTime learning for the next call to a time service, ignoring
  710. the next time and date set, disabling or reenabling DOS clock maintenance,
  711. and disabling or reenabling 0.01 sec resolution in the DOS clock.
  712.  
  713.   For further information about these and other RighTime functions, please
  714. consult the RighTime manual.  Note that while Life Sciences Software has
  715. permission to distribute evaluation copies of RighTime to registered users of
  716. TimeSet, RighTime is a shareware program owned by Tom Becker of Air System 
  717. Technologies, Inc. of Dallas.  Registration of RighTime and technical
  718. questions about it should be directed to Air System Technologies, not to us.
  719.  
  720.  
  721. COMMAND LINE SWITCHES
  722.  
  723.   Several command line switches are available for TimeSet, and most of them
  724. can be reviewed by typing "timeset ?" at the DOS prompt.  For reference, here 
  725. is a complete list of what is available.  Note that all such commands are
  726. preceded by a forward slash (/) and that more than one can be used on the
  727. command line (with no need to be separated by a space):
  728.  
  729.   /ab, /aw, /ae, /at -- These commands, all of which are preceded by "/a", 
  730. allow TimeSet to be run in automatic mode even if it has been configured for
  731. manual operation.  Recall that automatic operation means dialing a specific
  732. time service, getting the time, and immediately exiting to DOS.  The second
  733. letter in each command designates the time service to be called automatically;
  734. "b" stands for Boulder (NIST); "w" stands for Washington (USNO); "e" stands
  735. for a European time service (provided a number for one was selected during
  736. configuration); and "t" stands for a TimeGen time service (provided a phone
  737. number for one was entered during configuration).
  738.  
  739.   /fs  -- This command eliminates the "parting curtains" special effect used 
  740. by TimeSet when one screen replaces another, causing screen changes to occur
  741. almost instantly.
  742.  
  743.   /s -- This command causes TimeSet to skip the logo screen (the starry sky)
  744. when loaded and instead go directly to the main menu.
  745.  
  746.   /lag -- This command specifies line delay measurement for the time service
  747. selected for automatic operation with a "/a" command (see above).  Thus if
  748. you wanted to call NIST with line delay measurement, the command line would 
  749. be "timeset /ab/lag."
  750.  
  751.   /m -- Loads TimeSet with forced monochrome display, whether in manual or
  752. automatic dialing mode.
  753.  
  754.   /p, /0p -- The /p command tells TimeSet to generate a pulse at pin 1 of the
  755. parallel port at the instant the clock is set, just as would occur if F9 were
  756. pressed at the main menu before placing a call.  The function needs to be
  757. available as an optional command line switch when TimeSet is run in any
  758. automatic mode.  The /0p is alternative command for pulse generation. 
  759. Unlike /p, which causes a pulse to be generated at the instant of time 
  760. setting, /0p delays pulse generation until seconds in the newly set time are 
  761. equal to zero, that is, until the minute changes.  This can be useful in 
  762. situations where an external device needs to be started on the minute. 
  763. (See /lptn command, below.)
  764.  
  765.   /0c -- The /0c command is similar to the /0p command in that it causes a
  766. countdown to zero seconds after the new time is obtained.  It differs from
  767. /0p, however, in that a pulse is not generated at the parallel port when the
  768. next minute arrives.  It simply provides a countdown for the convenience of
  769. those who want to synchronize a watch or a clock manually.
  770.  
  771.   /lptn -- This command specifies the parallel port to be used for generating a
  772. pulse at the instant of clock setting (lpt1, lpt2, etc.).  The default is 
  773. lpt1, so the command is not necessary if that is the port you want to use or 
  774. if it is the only parallel port you have.
  775.  
  776.   /lf -- This command tells TimeSet to append timesetting data to a log file. 
  777. The log file, named TimeSet.Log, is maintained on TimeSet's home directory
  778. and includes the date of a call, the service called, the computer time before
  779. and after the call, and the error (i.e., the difference between the time 
  780. before and after the call).
  781.  
  782.   /wb, /ww, /we, /wt -- These commands tell TimeSet to wait at the opening
  783. menu until a specified time, then call a time service (b, w, e, and t specify the
  784. time service to be called.  The command must be followed by the time you
  785. want the call to be made, in hours, minutes, and seconds using the standard
  786. DOS time format (midnight = 00:00:00, 1 pm = 13:00:00, etc.).  Thus if you
  787. wanted TimeSet to wait until 5:00 a.m. and call the USNO, the command would 
  788. be /ww05:00:00.  Note that there should be no space between the command and 
  789. the time.  (NOTE: A far better method than a /w command for timing a call is 
  790. to load the companion program AutoDial, which is part of the TimeSet 7.20 
  791. package.  This is a memory-resident program that detects the presence of 
  792. TimeSet 7.20 and initiates a call to a given time service at a particular 
  793. time, both of which are specified when AutoDial is loaded.  AutoDial is 
  794. discussed in detail in a separate section below.)
  795.  
  796.  
  797.                           CALLING AND CONNECTING
  798.  
  799.   As soon as dialing is initiated, a new screen appears (Figure 4) displaying
  800. modem intitialization commands and the phone number as they are being fed to 
  801. the modem.  The service being called is also displayed.
  802.  
  803.   When connection is made, a new screen appears that includes a window for
  804. displaying incoming data strings (Figure 5).  The strings begin to appear in
  805. just a few seconds.  Eight or nine such strings are displayed before the final
  806. one is captured for parsing and use in setting the clock.  The purpose is to
  807. allow time for modem "jitter" to abate.
  808.  
  809.  
  810.                             THE SUMMARY SCREEN
  811.  
  812.   The summary screen (Figure 6) is the last screen that appears during a
  813. TimeSet run.  This screen displays information on the results of the call,
  814. including UTC data, the delay correction used, and the local time and date
  815. before and after.  If TimeSet 7.20 was loaded with the /lf command line
  816. switch, the local time data will be appended to the file TimeSet.Log, which
  817. will be in TimeSet's home directory.
  818.  
  819.  
  820.                              DOS ERROR LEVELS
  821.                           
  822.   Whenever TimeSet 7.20 finishes its work and exits to DOS it supplies DOS
  823. with a code that indicates what condition caused the program to end.  This
  824. code can be read with DOS's ErrorLevel command in a batch file.  Error level
  825. codes supplied by TimeSet are most useful when the program is configured for
  826. automatic operation and run from a batch file -- on bootup, for example.  They
  827. allow a user to design the .BAT file so it can read the code using the 
  828. ErrorLevel command and take some desired action depending on what the error
  829. level is.  Your DOS manual explains how to use the ErrorLevel command.  If you
  830. wish to design such a batch file, here are TimeSet's error level codes and
  831. their meaning.  Keep in mind that the full set is possible only if TimeSet is
  832. configured for automatic operation:
  833.  
  834.            0 -- Call was completed normally, time and date set
  835.            1 -- Carrier was lost while call in progress
  836.            2 -- Line was busy (10 automatic dial attempts)
  837.            3 -- No dial tone was detected
  838.            4 -- Line was too noisy (15 garbled strings in a row)
  839.            5 -- Program was terminated by user
  840.                           
  841. There is no point in trying to use error levels if TimeSet is configured for 
  842. manual operation (since the program in manual mode is always terminated by the 
  843. user, the code returned to DOS will always be 5).
  844.  
  845.  
  846.                           LINE DELAY MEASUREMENT
  847.  
  848.   Line delay is the time it takes for a time mark sent by a telephone time
  849. service to reach your computer.  It consists of two major components, the
  850. actual time it takes the character to travel through the telephone system and
  851. delays introduced by modems and your own computer.  For land line 
  852. communication less than a few thousand miles, modem delay is a far larger
  853. contributor than phone system delay.  Phone system delay is typically around
  854. 7 ms in calls to a U.S. time service from any point in the country over land 
  855. lines, whereas modem delay can be 40 or 50 ms or greater.
  856.  
  857.   Except for the Italian service, line delay measurement is available for all
  858. time services addressable by TimeSet.  At this time it appears that there are
  859. no plans to add line delay measurement capability to the Italian service. 
  860. Accordingly, if you have configured for the Italian service and press Alt-E,
  861. TimeSet will not initiate the call and will instead display a message reminding
  862. you of the unavailability of line delay measurement with that service; only the
  863. E command alone will work with the Italian service. 
  864.  
  865.   Line delay measurement makes the most sense when one or more of the
  866. following conditions exist: (1) you need the most accurate time setting 
  867. possible for some special purpose; (2) your connection to the time service is
  868. by satellite (which can cause up to a quarter-second delay); and (3) you have
  869. Becker's RighTime installed to maintain that high accuracy in your clock for 
  870. a reasonable length of time.  Without RighTime installed, a computer clock
  871. can drift up to 15 or more seconds a day; if you can tolerate a significant
  872. daily drift you obviously don't need to worry about a fraction of a second of
  873. time setting delay.  
  874.  
  875.   If none of these conditions exists, a call without line delay measurement is 
  876. probably accurate enough and usually takes a lot less time.  Furthermore,
  877. nearly all the time services routinely advance the departure of their time mark
  878. by a fixed amount to give an approximate precompensation for land line and
  879. modem delays when actual measurement is not requested.  Usually, that fixed
  880. amount of advance is very close, within a few hundredths of a second, to the
  881. line delay that could actually be measured on a land-line call within the same 
  882. country.  The one exception is the USNO, and TimeSet takes care of that by
  883. adding .05 seconds for delay to the set time when delay is not actually
  884. measured with the USNO.
  885.  
  886.   The various atomic time services use different methods for delay 
  887. measurement.  The NIST measures delay for you, then advances its time mark to 
  888. compensate for it so the mark arrives on time.  The USNO lets the caller 
  889. measure the delay by means of a remote digital loopback (RDL) test then add 
  890. the measured delay to the new time before setting the clock (to make the 
  891. delay measurement you must have a modem that accepts the &T6 and &T0 commands
  892. for RDL).  The Swedish and Austrian services also let the caller measure the 
  893. delay, but by a method that does not require RDL.  As noted, the Italian 
  894. service does not offer delay measurement.
  895.  
  896.   Delay measurements done by TimeSet 7.20 are far more accurate than in any 
  897. previous version, with resolution to .0001 second (the measured value is
  898. rounded to the nearest .01 second before use, however, since that is the
  899. smallest unit of time the DOS clock will accept).  
  900.  
  901.  
  902.                               USING AUTODIAL
  903.  
  904.   AutoDial, a memory-resident program for controlling TimeSet 7.20, is a new
  905. program that is part of the TimeSet 7.20 package.  The program occupies about 
  906. 10k of memory and can be loaded in high memory with a memory manager. Its 
  907. purpose is to trigger a call to a specified time service at a preselected 
  908. time.  TimeSet must be configured for manual operation if you want to use 
  909. AutoDial to control its operation.  Both the service to be called and the 
  910. time to call it are specified on the command line when AutoDial is loaded.
  911.  
  912.   The syntax for loading AutoDial is:
  913.  
  914.                   AutoDial <service and method> <time>
  915.  
  916.   There are eight options for <service and method>:  NIST, NIST/d, USNO,
  917. USNO/d, Euro, Euro/d, TGen, and TGen/d, where NIST is the National Institute 
  918. of Standards and Technology, USNO is the U.S. Naval Observatory, Euro is the 
  919. European time service selected during configuration, and TGen is the TimeGen 
  920. service specified during configuration.  /d means dial the selected time 
  921. service with delay measurement.  If you don't want delay measurement, just 
  922. type the name of service alone, without /d.
  923.  
  924.   <Time> is the time when the call to the specified time service is to be
  925. initiated.  It can be entered in a couple of ways.  If the calling time is exactly
  926. on the hour (0 minutes), only the hour need be entered, but if the time is
  927. some minutes after the hour, both the hour and minutes must be entered and
  928. separated by a colon (hh:mm).
  929.  
  930.   For example, if you wanted to have TimeSet call the NIST at 4 a.m. without
  931. delay measurement, you would load AutoDial as follows:
  932.  
  933.                                AutoDial NIST 4
  934.  
  935. (You could also write AutoDial NIST 04:00, but it isn't necessary.)
  936.  
  937.   If you wanted to have TimeSet call the NIST at 5:15 a.m. with delay
  938. measurement you would use:
  939.  
  940.                             AutoDial NIST/d 5:15
  941.  
  942.   Although AutoDial remains in memory, it has no function unless it detects
  943. that TimeSet 7.20 is loaded and waiting for user input, either at it's main
  944. menu or at its final summary screen.  This means, of course, that AutoDial
  945. will be of no use if TimeSet is configured for automatic operation.  
  946.  
  947.   If TimeSet is at its main menu when the appointed time arrives, dialing of
  948. the selected time service will proceed just as if you had pressed the
  949. appropriate key or keys for that service.  If TimeSet is at its summary 
  950. screen, redialing will occur just as if you had pressed the space bar to 
  951. initiate it manually (be aware, however, that if you have called a service 
  952. other than the one you specified when you loaded AutoDial, that will be the 
  953. service redialed if TimeSet is at its final screen when the selected time 
  954. comes around).
  955.  
  956.   To change the time service or the time when a call is to be triggered by
  957. AutoDial, you first have to remove it from DOS memory by typing AutoDial
  958. /u at the DOS prompt then reload it with the new time service and the new
  959. time.
  960.  
  961.   AutoDial also can trigger automatic update calls to a specified atomic time
  962. source by TimeGen, a time data generator program that allows a local
  963. computer to serve as a time source for other local computers.  TimeGen is
  964. discussed in the next section.
  965.  
  966.  
  967. If2Day.COM
  968.  
  969.   For the benefit of TimeSet users who do not want to make an automatic
  970. timesetting call daily with AutoDial but would like one done automatically on
  971. certain days of the week or month during bootup, Gary Miller has kindly
  972. given us permission to include his excellent If2Day.Com program in the
  973. TimeSet 7.20 package.  If2Day, a free program, is a batch file enhancer that
  974. can be invoked through the AutoExec.Bat file.  For example, if you wanted
  975. TimeSet to call NIST on bootup every Wednesday morning, you could put the
  976. following line in your AutoExec file:
  977.  
  978.          If2Day is_Wednesday aft_7:59 B4_9:00 run timeset /ab/lag
  979.   
  980. This would cause TimeSet to call Boulder and set the time automatically
  981. whenever the computer is started on a Wednesday morning between 8:00 and
  982. 9:00.
  983.  
  984.   If2Day.Com and its document are in the TimeSet 7.20 package as a separate 
  985. archive called If2Day.Zip.
  986.  
  987.  
  988.                                USING TIMEGEN
  989.  
  990.   TimeGen ver. 3.10, a companion program for TimeSet, is also part of the
  991. TimeSet 7.20 package.  TimeGen is a program that allows any computer to
  992. function as a "substation" of one of the official atomic time services.  Like 
  993. any of the official services, it waits for the phone to ring, then sends a 
  994. time data string every second to a calling computer equipped with TimeSet 
  995. 7.20.  The advantage it provides is that only the TimeGen-equipped computer 
  996. needs to call a time service periodically for a time update and can then pass 
  997. accurate time to many local computers.  
  998.  
  999.   A number of uses are possible for TimeGen.  For example, it could provide
  1000. a local source of accurate time for computerists in many nations that lack
  1001. atomic clocks, as well as in nations that have them but do not provide modem
  1002. access to the general public.  Such services might be offered to local callers
  1003. by telephone companies in any country, for example.  (Be advised, however,
  1004. that licensing and royalty arrangements MUST be made with Life Sciences
  1005. Software if tolls are charged for such services.)  Another possible use is
  1006. providing a local time source for an organization that has several offices in 
  1007. a given area, such as banks and other businesses with branch offices or police
  1008. departments with precinct stations.  Of course, it could also serve as a 
  1009. central time source for multiple computers housed in a single office building.  
  1010. In any application, the TimeGen computer could be dedicated either full time 
  1011. or only during certain hours to providing time signals.
  1012.  
  1013.   Like TimeSet 7.20 itself, TimeGen is designed to interact with AutoDial.  If
  1014. AutoDial is memory resident, it will trigger TimeGen to call a selected 
  1015. atomic time source at a specified time each day.  This means that TimeGen
  1016. will be unavailable to callers while the update call is in progress.  However,
  1017. this process takes less than a minute out of the entire day and can be
  1018. scheduled for a time of day when incoming calls are at a minimum.  During
  1019. that brief time, a caller would only get a busy signal.  
  1020.  
  1021.   Using TimeGen as a local source of time makes no sense if Becker's RighTime 
  1022. is not also installed to regulate the TimeGen computer's clock, since the 
  1023. clock could otherwise drift several seconds a day.  For this reason, it is 
  1024. strongly recommended that RighTime 2.54 be installed with its correction
  1025. already "learned" before going online with a TimeGen service.  Also be aware
  1026. that RighTime requires a CMOS clock to operate, which means the computer
  1027. must be an AT-class computer or later.  The DOS version must be 3.3 or later.  
  1028. Tests show that with RighTime 2.54 installed, regulating well, updated daily 
  1029. with an automatic call to an atomic time service, and providing 0.01 second 
  1030. DOS clock resolution, setting a computer's clock through TimeGen is as 
  1031. accurate as setting it from an official atomic time service.
  1032.  
  1033.   TimeGen's data strings are a modification of the U.S. Naval Observatory's
  1034. data strings and have the following format:
  1035.  
  1036.                  JJJJJ DDD HHMMSS UTC [message field]  *
  1037.  
  1038. where JJJJJ is the modified Julian date; DDD is the day of the year; HHMMSS 
  1039. are the hours, minutes, and seconds; and the letters UTC indicate that all 
  1040. of the data preceding it refer to Coordinated Universal Time (i.e., the
  1041. modified Julian date, day of the year, and time all apply to 0 degrees
  1042. longitude).  The asterisk (*) is the marker for the new second just announced
  1043. in the string and appears after a very brief pause.
  1044.  
  1045.   TimeSet 7.20 is designed to initiate line and modem delay measurement
  1046. with a TimeGen service, and it does it the same way as with the Naval
  1047. Observatory, that is, by remote digital loopback (RDL).  This means that if
  1048. the TimeGen service wishes to provide RDL, both its modem and the caller's
  1049. modem must have that capability and use the &T6 and &T0 commands.  As with 
  1050. calls to the Naval  Observatory, TimeSet 7.20 adds the measured delay to the 
  1051. new time before setting the computer clock.  If RDL is not requested, TimeSet 
  1052. adds an estimated delay value instead.
  1053.  
  1054.  
  1055. LOADING TIMEGEN
  1056.  
  1057.   TimeSet will not run at all if you try to load it without information on the
  1058. command line.  Instead it will simply tell you what information it needs to
  1059. run.
  1060.  
  1061.   The command for TimeGen is:
  1062.  
  1063.                 TimeGen <offset> [COMn] [/OTM] [Modem commands]
  1064.  
  1065. Notice that a space must separate each of the command line switches.
  1066.  
  1067.  
  1068. <offset> is the number of hours difference between your local time and
  1069. universal time.  This value must be supplied, whereas the others can be
  1070. optional.  The number must be preceded by a minus sign if your location is
  1071. west of 0 degrees longitude and east of the International Dateline (e.g., 
  1072. North or South America).  Do not separate the minus sign from the number 
  1073. with a space or any other character.  If you live east of 0 degrees and west 
  1074. of the International Dateline (e.g., Europe, Asia, Africa), the number alone 
  1075. is sufficient (don't use a plus sign).  
  1076.  
  1077.   If you live in an area that has time seasons (daylight time and standard
  1078. time, or summer time and winter time as they are called in Europe) you need
  1079. to take this into account in determining <offset> for your locality, and
  1080. change it when the seasons change.  A convenient way to do this would be to
  1081. create two .BAT files, one called Winter.Bat and the other called Summer.Bat
  1082. to load TimeGen with the correct offset for the current time season.  In most
  1083. places in the world where daylight (summer) time is used, an even hour is
  1084. added to the local time during the spring and summer months (in a few regions 
  1085. the advance in local time during those months is 1.5 hours).  Whenever your 
  1086. locality goes on daylight saving time, you will need to add the appropriate 
  1087. advance to your standard offset from UTC.  In the Americas, this will make 
  1088. <offset> smaller since you are adding a positive number to a negative number.  
  1089. In Eurasia, it will make <offset> larger since you are adding two positive 
  1090. numbers.
  1091.  
  1092.   The following table illustrates how to handle the value of <offset> when
  1093. daylight time and standard time are in effect:
  1094.  
  1095.         Country                   Standard time     Daylight time
  1096.         -------------             -------------     -------------
  1097.         United States
  1098.             Eastern                    -5                -4
  1099.             Central                    -6                -5
  1100.             Mountain                   -7                -6
  1101.             Pacific                    -8                -7
  1102.  
  1103.         United Kingdom                  0                 1
  1104.         Sweden                          2                 3
  1105.  
  1106.  
  1107. [COMn] is the serial port to which your modem is attached.  If you are using
  1108. COM1, this switch is optional since COM1 is the default.  If you are using
  1109. another port, however, you must specify it here (COM2, COM3, COM4, etc.).
  1110.  
  1111. [/OTM] is also optional but is very useful for calibrating TimeGen's on-time
  1112. mark (the asterisk) for maximum accuracy -- PROVIDED that RighTime 2.53 or
  1113. later is installed to give the DOS clock .01-sec resolution.  You should
  1114. NEVER use /OTM without .01-second clock resolution, since the purpose of the 
  1115. switch is to advance the time mark in increments of .01 second to compensate 
  1116. for internal delays in transmitting the mark to the calling computer.  (If you
  1117. try to use /OTM without .01 second clock resolution from RighTime 2.5+, the
  1118. standard DOS clock resolution of .055 second will cause string generation and 
  1119. transmission to occur at agonizingly long intervals instead of every second,
  1120. causing gross timesetting errors for a caller.)  
  1121.  
  1122. With RighTime 2.5+ installed, setting /OTM to /1 will advance the mark by .01 
  1123. second, /2 by .02 second, /3 by .03 second.  There should never be any need to 
  1124. advance it by much more than .03 second, and putting in unrealistic values 
  1125. such as /50 (half a second) will produce bizarre results.  Tests on several 
  1126. computers indicate that /2 (.02 seconds) is likely to be the optimal value for 
  1127. most systems.  To determine the optimal value for your own TimeGen-equipped 
  1128. computer, a calling computer using TimeSet 7.20 and equipped with RighTime 
  1129. 2.5+ to provide .01 second clock resolution needs to place several calls in 
  1130. quick succession, alternating between the TimeGen computer and an official 
  1131. time source and using line delay measurement in both cases.  All that is 
  1132. needed then is to determine the average discrepancy between the two services 
  1133. and use that value for /OTM on TimeGen's command line each time it's loaded.  
  1134. Since the value is a time mark advance, it should never be negative.
  1135.  
  1136. [modem] is an option for supplying additional commands to the local modem.
  1137. All such commands must be preceded by "AT."  Thus, if you wanted the modem 
  1138. to answer on the third ring, you would enter ATS0=3.  Modem commands can 
  1139. also be stacked.  For example, if you have a high speed modem that uses &F 
  1140. to get into basic asynchronous mode you would need to enter AT&FS0=3.  Basic 
  1141. asynchronous mode is advised with such modems since data compression and 
  1142. error checking protocols such as MNP interfere with accuracy.
  1143.  
  1144.   Once TimeGen is loaded, it simply waits for the phone to ring.  If a carrier
  1145. is detected, TimeGen synthesizes Naval Observatory-style UTC data strings
  1146. from the local computer's DOS clock and transmits one string per second until 
  1147. the caller hangs up or until 60 such strings have been sent, allowing each
  1148. caller up to a minute of connect time.  Time data strings and their time
  1149. marks are displayed on TimeGen's screen as they are transmitted.
  1150.  
  1151.   A major enhancement in TimeGen Version 3.1 is automatic logging of call data.
  1152. At the conclusion of each call for time, TimeGen 3.1 saves information to the
  1153. file TimeGen.LOG, which will always be located in TimeGen's own directory --
  1154. provided your DOS version is 3.0 or later and the TimeGen directory is on your
  1155. system path.  The information logged for each call includes the date, time the
  1156. call was concluded, call duration, and nature of the call (with/without line 
  1157. delay measurement or aborted).  A separate utility called TgSumm.COM can 
  1158. process the data in TimeGen.LOG to a create a summary of call data by date 
  1159. and cumulatively, which is displayed on your screen and is also saved to a 
  1160. file called TGSummry.LOG for later reference.  TgSumm should always be run in 
  1161. the same directory that contains TimeGen.LOG.
  1162.  
  1163.   If AutoDial is loaded, TimeGen will automatically call an atomic time
  1164. service once a day at the specified time for updating.  Once again, given the
  1165. notorious unreliability of computer clocks, it is important to have RighTime
  1166. 2.54 loaded in the TimeGen computer to make the whole process meaningful.
  1167.  
  1168.                               
  1169.                               TECHNICAL SUPPORT
  1170.  
  1171.   All registered users of TimeSet are entitled to technical support.  I also
  1172. provide guidance on getting the program running for people who have not yet
  1173. registered.  The best and the quickest way to get help is simply to call.  I
  1174. recommend that you do not write.  Since I am a very small one-man business
  1175. I can't guarantee you a timely written response.  
  1176.  
  1177.   My phone number is 206-387-9788.  
  1178.   
  1179.   In deciding when to call, please note that I am in the Pacific time zone
  1180. and that my normal hours for technical assistance calls are: 
  1181.                         
  1182.                         Monday through Friday
  1183.                         9:00 a.m. - 12:00 noon 
  1184.                         2:00 pm - 7:00 p.m. 
  1185.                         Pacific time 
  1186.                         
  1187. The mid-day break can vary, depending on how busy I am when lunch time comes 
  1188. around.  I do have an answering machine in case I'm not here to answer, but 
  1189. your best bet is to call again later.
  1190.  
  1191.   Another way to reach me is through Tom Becker's computer bulletin board at 
  1192. Air System Technologies, Inc., Dallas, where I function as a co-sysop for
  1193. TimeSet questions.  It is also a good place to download the latest versions of
  1194. TimeSet and RighTime.  The phone number is 214-869-2780.  The BBS can
  1195. handle speeds up to 14.4 kbaud, 8N1.
  1196.  
  1197.   Finally, I log on frequently to CompuServe.  You can leave messages for me
  1198. there anytime, and you can usually expect an answer within a day or two.  My
  1199. CIS number is 76555,1175.  TimeSet revisions are always uploaded to the
  1200. IBMSYS forum on CompuServe under a file name TSETnn.ZIP (or .EXE for a
  1201. self-extracting archive), where nn is the version number (e.g., the archive 
  1202. for TimeSet 7.20 will be TSET72).
  1203.  
  1204.   Thanks very much for supporting shareware.
  1205.  
  1206. Sincerely,
  1207.  
  1208.           Pete Petrakis
  1209.           Life Sciences Software
  1210.           Box 1560
  1211.           8925 271st St., N.W., Suite 112
  1212.           Stanwood, WA 98292
  1213.  
  1214.  
  1215.                           TIMESET MAIL REGISTRATION
  1216.  
  1217.  
  1218. To:  Life Sciences Software
  1219.      8925 271st Street, N.W., Suite 112
  1220.      Box 1560
  1221.      Stanwood, WA 98292
  1222.  
  1223.  
  1224. My name: __________________________________________________________________
  1225.  
  1226. My addresss: ______________________________________________________________
  1227.  
  1228.             
  1229.              ______________________________________________________________
  1230.  
  1231. My city, state, Zip: ______________________________________________________
  1232.  
  1233. My phone number: ____________________________
  1234.  
  1235.  
  1236. I wish to become a registered user of TimeSet version 7.20.
  1237.  
  1238. I request ___ copies of TimeSet 7.20 and supporting programs, a printed
  1239. TimeSet manual for each, and an evaluation copy of Becker's RighTime CMOS 
  1240. clock regulating shareware program.
  1241.  
  1242. My current TimeSet registration status is as follows:
  1243.  
  1244.              (Please check the appropriate line below)
  1245.      ___ I am registering TimeSet for the first time       ($40.00)
  1246.      ___ I have already registered and did so before 1992  ($25.00)
  1247.      ___ I have already registered and did so during 1992  ($20.00)
  1248.         
  1249.  
  1250. (To Washington State residents:  As a licensed business in the state of
  1251. Washington we are required to charge 7.9 percent sales tax on sales made
  1252. within the state.  Please include the tax when you calculate the amount 
  1253. of your payment for the next item.)
  1254.  
  1255. I enclose a check or money order for $______.____ for ____ copies (including
  1256. sales tax if applicable).
  1257.  
  1258. My diskette preference is:  5-1/4"  _____     3-1/2" _____ (check one).
  1259.  
  1260.  
  1261.  
  1262.